package io.xccit.race.service;

import java.util.List;
import java.util.Map;
import io.xccit.race.domain.RaceCompetitionSignup;

/**
 * 竞赛报名信息Service接口
 * 
 * @author ywx
 * @date 2025-10-10
 */
public interface IRaceCompetitionSignupService 
{
    /**
     * 查询竞赛报名信息
     * 
     * @param id 竞赛报名信息主键
     * @return 竞赛报名信息
     */
    public RaceCompetitionSignup selectRaceCompetitionSignupById(Long id);

    /**
     * 查询竞赛报名信息列表
     * 
     * @param raceCompetitionSignup 竞赛报名信息
     * @return 竞赛报名信息集合
     */
    public List<RaceCompetitionSignup> selectRaceCompetitionSignupList(RaceCompetitionSignup raceCompetitionSignup);

    /**
     * 新增竞赛报名信息
     * 
     * @param raceCompetitionSignup 竞赛报名信息
     * @return 结果
     */
    public int insertRaceCompetitionSignup(RaceCompetitionSignup raceCompetitionSignup);

    /**
     * 修改竞赛报名信息
     * 
     * @param raceCompetitionSignup 竞赛报名信息
     * @return 结果
     */
    public int updateRaceCompetitionSignup(RaceCompetitionSignup raceCompetitionSignup);

    /**
     * 批量删除竞赛报名信息
     * 
     * @param ids 需要删除的竞赛报名信息主键集合
     * @return 结果
     */
    public int deleteRaceCompetitionSignupByIds(Long[] ids);

    /**
     * 删除竞赛报名信息信息
     * 
     * @param id 竞赛报名信息主键
     * @return 结果
     */
    public int deleteRaceCompetitionSignupById(Long id);

    /**
     * 根据竞赛ID查询报名信息
     * 
     * @param competitionId 竞赛ID
     * @return 报名信息列表
     */
    public List<RaceCompetitionSignup> selectRaceCompetitionSignupByCompetitionId(Long competitionId);

    /**
     * 根据姓名查询报名信息
     * 
     * @param participantName 参赛者姓名
     * @return 报名信息列表
     */
    public List<RaceCompetitionSignup> selectRaceCompetitionSignupByName(String participantName);

    /**
     * 根据学校查询报名信息
     * 
     * @param schoolName 学校名称
     * @return 报名信息列表
     */
    public List<RaceCompetitionSignup> selectRaceCompetitionSignupBySchool(String schoolName);

    /**
     * 统计竞赛报名数量
     * 
     * @param competitionId 竞赛ID
     * @return 报名数量
     */
    public Long countSignupByCompetitionId(Long competitionId);

    /**
     * 统计团队报名数量
     * 
     * @param competitionId 竞赛ID
     * @return 团队报名数量
     */
    public Long countTeamSignupByCompetitionId(Long competitionId);

    /**
     * 统计个人报名数量
     * 
     * @param competitionId 竞赛ID
     * @return 个人报名数量
     */
    public Long countIndividualSignupByCompetitionId(Long competitionId);

    /**
     * 获取报名统计信息
     * 
     * @param competitionId 竞赛ID
     * @return 统计信息
     */
    public Map<String, Object> getSignupStatistics(Long competitionId);

    /**
     * 检查报名是否重复
     * 
     * @param raceCompetitionSignup 报名信息
     * @return 是否重复
     */
    public boolean checkDuplicateSignup(RaceCompetitionSignup raceCompetitionSignup);

    /**
     * 审核报名信息
     * 
     * @param id 报名ID
     * @param status 审核状态
     * @param auditRemark 审核备注
     * @return 结果
     */
    public int auditSignup(Long id, Integer status, String auditRemark);

    /**
     * 取消报名
     * 
     * @param id 报名ID
     * @param userId 用户ID
     * @return 结果
     */
    public int cancelSignup(Long id, Long userId);

    /**
     * 根据用户ID统计报名数量
     * 
     * @param userId 用户ID
     * @return 报名数量
     */
    public Long countSignupByUserId(Long userId);

    /**
     * 根据用户ID统计获奖数量
     * 
     * @param userId 用户ID
     * @return 获奖数量
     */
    public Long countAwardByUserId(Long userId);

    /**
     * 检查手机号是否已报名指定竞赛
     * 
     * @param competitionId 竞赛ID
     * @param phone 手机号
     * @return 是否已报名
     */
    public boolean checkPhoneRegistration(Long competitionId, String phone);

    /**
     * 检查学号报名冲突（同一天竞赛时间冲突）
     * 
     * @param competitionId 竞赛ID
     * @param studentId 学号
     * @return 是否有冲突
     */
    public boolean checkRegistrationConflict(Long competitionId, String studentId);

    /**
     * 根据当前登录用户手机号查询报名详情
     * 
     * @return 报名记录列表
     */
    public List<RaceCompetitionSignup> getRegistrationsByCurrentUserPhone();
}
